MARQUEENN n/a   IE 4   DOM n/a

The MARQUEE object reflects the MARQUEE element.

 
HTML Equivalent
<MARQUEE>
 
Object Model Reference
IE [window.]document.all.elementID
accessKeyNN n/a   IE 4   DOM n/a
 Read/Write
 

A single character key that brings focus to the element. The browser and operating system determine whether the user must press a modifier key (e.g., Ctrl, Alt, or Command) with the access key to bring focus to the element. In IE 4/Windows, the Alt key is required, and the key is not case sensitive. Not working in IE 4/Mac.

 
Example
document.all.myBanner.accessKey = "n"
 
Value
Single alphanumeric (and punctuation) keyboard character.
 
Default None.
behaviorNN n/a   IE 4   DOM n/a
 Read/Write
 

The motion of the content within the rectangular space set aside for the MARQUEE element. You have a choice of three motion types.

 
Example
document.all.newsBanner.behavior = "slide"
 
Value
Case-insensitive MARQUEE element motion types:
alternate Content alternates between marching left and right.
scroll Content scrolls (according to the DIRECTION attribute or direction property) into view and out of view before starting again.
slide Content scrolls (according to the DIRECTION attribute or direction property) into view, stops at the end of its run, blanks, and then starts again.
 
Default scroll
bgColorNN n/a   IE 4   DOM n/a
 Read/Write
 

Background color of the element. This color setting is not reflected in the style sheet backgroundColor property except for Navigator layer objects. Even if the BGCOLOR attribute or bgColor property is set with a plain-language color name, the returned value is always a hexadecimal triplet.

 
Example
document.all.myBanner.bgColor = "yellow"
 
Value
A hexadecimal triplet or plain-language color name.
 
Default Varies with browser and operating system.
clientHeight, clientWidthNN n/a   IE 4   DOM n/a
 Read/Write
 

According to Microsoft's developer documentation, these properties reflect the height and width (in pixels) of the element's content.

 
Example
var midHeight = document.all.myBanner.clientHeight/2
 
Value
Integer pixel value.
 
Default None.
clientLeft, clientTopNN n/a   IE 4   DOM n/a
 Read-only
 

According to Microsoft's developer documentation, these properties reflect the distance between the "true" left and top edges of the document area and the edges of the element. To get or set the pixel position of an element in the document, use the pixelLeft and pixelTop properties.

 
Value
A string value for a length in a variety of units or percentage.
 
Default None.
dataFldNN n/a   IE 4   DOM n/a
 Read/Write
 

Used with IE 4 data binding to associate a remote data source column name with the content of the MARQUEE element. A DATASRC attribute must also be set for the element. Setting both the dataFld and dataSrc properties to empty strings breaks the binding between element and data source.

 
Example
document.all.myBanner.dataFld = "hotNews"
 
Value
Case-sensitive identifier of the data source column.
 
Default None.
dataFormatAsNN n/a   IE 4   DOM n/a
 Read/Write
 

Used with IE 4 data binding, this property advises the browser whether the source material arriving from the data source is to be treated as plain text or as tagged HTML.

 
Example
document.all.myBanner.dataFormatAs = "text"
 
Value
IE 4 recognizes two possible settings: text | HTML.
 
Default text
dataSrcNN n/a   IE 4   DOM n/a
 Read/Write
 

Used with IE 4 data binding to specify the name of the remote ODBC data source (such as an Oracle or SQL Server database) to be associated with the element. Setting both the dataFld and dataSrc properties to empty strings breaks the binding between element and data source.

 
Example
document.all.myBanner.dataSrc = "#DBSRC3"
 
Value
Case-sensitive identifier of the data source.
 
Default None.
directionNN n/a   IE 4   DOM n/a
 Read/Write
 

Direction of the scroll within the element space.

 
Example
document.all.banner.direction = "down"
 
Value
Four possible case-insensitive directions: down | left | right | up.
 
Default left
height, widthNN n/a   IE 4   DOM n/a
 Read/Write
 

The height and width in pixels of the element. Changes to these values are immediately reflected in reflowed content on the page.

 
Example
document.all.myBanner.height = 250
 
Value
Integer.
 
Default None.
hspace, vspaceNN n/a   IE 4   DOM n/a
 Read/Write
 

The pixel measure of horizontal and vertical margins surrounding the element. The hspace property affects the left and right edges of the element equally; the vspace affects the top and bottom edges of the element equally. These margins are not the same as margins set by style sheets, but they have the same visual effect.

 
Example
document.all.myBanner.hspace = 5
document.all.myBanner.vspace = 8
 
Value
Integer of pixel count.
 
Default 0
loopNN n/a   IE 4   DOM n/a
 Read/Write
 

Sets the number of times the element scrolls its content. After the final scroll, the content remains in a fixed position. Constant animation can sometimes be distracting to page visitors, so if you have the MARQUEE turn itself off after a few scrolls, you may be doing your visitors a favor.

 
Example
document.all.banner.loop = 3
 
Value
Any positive integer if you want the scrolling to stop after that number of times. Otherwise, set the value to -1.
 
Default -1
recordNumberNN n/a   IE 4   DOM n/a
 Read-only
 

Used with data binding, returns an integer representing the record within the data set that generated the element (i.e., an element whose content is filled via data binding). Values of this property can be used to extract a specific record from an Active Data Objects (ADO) record set (see recordset property).

 
Example
<SCRIPT FOR="tableTemplate" EVENT="onclick">
    myDataCollection.recordset.absoluteposition = this.recordNumber
    ...
</SCRIPT>
 
Value
Integer.
 
Default None.
scrollAmountNN n/a   IE 4   DOM n/a
 Read/Write
 

The amount of space between positions of each drawing of the content. The greater the space, the faster the text appears to scroll. See also scrollDelay.

 
Example
document.all.banner.scrollAmount = 4
 
Value
Positive integer.
 
Default 6
scrollDelayNN n/a   IE 4   DOM n/a
 Read/Write
 

The amount of time in milliseconds between each drawing of the content. The greater the delay, the slower the text appears to scroll. See also scrollAmount.

 
Example
document.all.banner.scrollDelay = 100
 
Value
Positive integer.
 
Default 85 (Windows 95); 90 (Macintosh).
scrollHeight, scrollWidthNN n/a   IE 4   DOM n/a
 Read-only
 

The meaning of these two properties is ambiguous based on Microsoft's description and the way they're implemented in the Windows and Macintosh versions of Internet Explorer 4. My best guess is that these properties are intended to measure the height and width (in pixels) of the content of an element even when some of the content cannot be seen unless scrolled with scrollbars. The Macintosh version of the browser interprets this to mean the amount of the content that you can see at any one time. The important point is that for key elements, such as the BODY, the properties mean different things and can disrupt cross-platform operation.

 
Example
var midPoint = document.all.myBanner.scrollHeight/2
 
Value
Positive integer or zero.
 
Default None.
scrollLeft, scrollTopNN n/a   IE 4   DOM n/a
 Read/Write
 

The distance in pixels between the actual left or top edge of the element's physical content and the left or top edge of the visible portion of the content. Setting these properties does not appear to visually impact the display of content in the MARQUEE element.

 
Example
document.all.myBanner.scrollTop = 40
 
Value
Positive integer or zero.
 
Default 0
tabIndexNN n/a   IE 4   DOM 1
 Read/Write
 

A number that indicates the sequence of this element within the tabbing order of all focusable elements in the document. Tabbing order follows a strict set of rules. Elements that have values other than zero assigned to their tabIndex properties are first in line when a user starts tabbing in a page. Focus starts with the element with the lowest tabIndex value and proceeds in order to the highest value, regardless of physical location on the page or in the document. If two elements have the same tabIndex values, the element that comes earlier in the document receives focus first. Next come all elements that either don't support the tabIndex property or have the value set to zero. These elements receive focus in the order in which they appear in the document. A value of -1 removes the element from tabbing order altogether.

Note that the Macintosh user interface does not provide for giving focus to elements other than text and password INPUT fields.

 
Example
document.all.myBanner.tabIndex = 6
 
Value
Integer.
 
Default None.
trueSpeedNN n/a   IE 4   DOM n/a
 Read/Write
 

Whether the browser should honor SCROLLDELAY settings below 60 milliseconds. The default setting (false) prevents accidental settings that scroll too fast for most readers.

 
Example
document.all.banner.trueSpeed = "true"
 
Value
Boolean value: true | false.
 
Default false
blur( )NN n/a   IE 4   DOM n/a

Removes focus from the current element and fires an onBlur event (in IE). No other element necessarily receives focus as a result.

 
Returned Value
None.
 
Parameters
None.
focus( )NN n/a   IE 4   DOM n/a

Gives focus to the current element and fires the onFocus event (in IE). If another element had focus at the time, it receives an onBlur event.

 
Returned Value
None.
 
Parameters
None.
start( )NN n/a   IE 4   DOM n/a

Starts the MARQUEE element scrolling if it has been stopped. If the method is invoked on a stopped element, the onstart event handler also fires in response.

 
Returned Value
None.
 
Parameters
None.
stop( )NN n/a   IE 4   DOM n/a

Stops the scrolling of the MARQUEE element. The content remains on the screen in the precise position it was in when the method was invoked. Restart via the start( ) method.

 
Returned Value
None.
 
Parameters
None.